LoadFromDb

Metodo di oggetto

Carica un oggetto dalla base dati.

note

A fronte di un DFX avente più chiavi primarie, la chiave che verrà presa in considerazione come relazione sarà quella con indice 0.

warning

I campi della chiave primaria devono essere valorizzati sul record.

suggerimento

Per eseguire un nuovo caricamento da database dei dati è necessario eseguire il metodo Clear() sull'oggetto prima di eseguire il metodo LoadFromDb().

Definizione BC

È possibile utilizzare la seguente sintassi per utilizzare il metodo:

Metodo([Livello],[CaricaPersonalizzazioni],[AbilitaProfilazione])

Parametro	Formato	Riferimento	I/O	Default	Versione
Livello	Intero			-1
CaricaPersonalizzazioni	Intero			0
AbilitaProfilazione	Intero			0

Parametri

Livello

InteroInput

Indica il livello di lettura del modello dati.

Può essere una variabile o una costante, può assumere uno dei valori di seguito indicati:

Valore parametro	Descrizione
-1	viene letto tutto l’oggetto (default)
0	viene letto solo il base
1	fino al primo livello
2	fino al secondo livello
...	...
n	fino all’ n-esimo livello

Se è omesso il valore parametro si assume '-1' (meno uno) come default.

note

Il numero di livelli utilizzabili (n) è determinato dalla definizione del modello dati utilizzato.

CaricaPersonalizzazioni

InteroInput

Permette di caricare anche le personalizzazioni.

Può essere una variabile o una costante, può assumere i valori '0-No' oppure '1-Si'.

note

Se è omesso si assume '0' come default, in tale caso i dati personalizzati sono letti sfruttando il meccanismo di lazy loading.

warning

Da v.31.1, se Livello è -1 allora il default del parametro è 1 quindi vengono caricate anche le personalizzazioni. Inoltre, il valore del parametro viene salvato sull'oggetto e propagato ai sottolivelli in fase di lazy loading (a meno che non abbiano il carica in override).

AbilitaProfilazione

InteroInput

Permette di indicare l'abilitazione della profilazione.

Può essere una variabile o una costante numerica avente i seguenti valori:

Valore parametro	Descrizione
0	Profilazione disabilitata (default)
1	Vincoli della profilazione attivi (corrisponde al parametro VINCOLI). Se il record è soggetto ai vincoli della profilazione, non viene restituito. L'oggetto risulta vuoto dopo il metodo
2	Vincoli della profilazione attivi con NOPERM (corrisponde al parametro VINCOLI + #NOPERM). Se il record è soggetto ai vincoli della profilazione, viene comunque restituito caricato. Per sapere se è soggetto a vincoli è disponibile il metodo IsConstrained()

Esempi

Popolamento di un oggetto da db nel metodo Carica

 ' Metodo Carica
 
 This.Clear()
 Caricato = #False
 
 ' Controllo valore nullo
 If CodArt = "" Then ExitSr
 
 ' Se non viene richiesto l'utilizzo della cache la disattiva sull'oggetto da caricare
 If Not UtilizzaCache Then This.DisableCacheRead(1)
 
 ' Assegnazione primary key per effettuare il caricamento dell'oggetto
 This.CodArt = CodArt
 
 This.LoadFromDb(Livello)
 If Not This.IsEmpty() Then Caricato = #True